Aviation API

(0 reviews)

23 Weather Station Observation Data

A weather station comprises of instruments and equipment that measure atmospheric conditions. This observation data is reported back every minute for a specific location.

23.1 Latest for an Airport and Weather Station

Request the latest 1 minute observation data for an airport and weather station. See tables below for supported airport (ICAO code) and associated weather stations.

23.1.1 API Call:

GET /aviation/observations/airport/{ICAODesignator}/weatherStation/{stationId}/latest

23.1.2Path Parameters:

Path Parameter	Example	Description
ICAODesignator	NZWN	A supported ICAO airport code (upper case). See table below for valid codes. This parameter is Mandatory.
stationId	NZWNA	The identifier for the Weather Station (upper case). See table below for valid Weather Station Identifiers. This parameter is Mandatory.

23.1.3 Example:

This example would return the latest observations for Wellington Airport for weather station A.

GET /aviation/observations/airport/NZWN/weatherStation/NZWNA/latest

23.1.4API Response:

{
    "version":"1.0",
    "issue-time":"2019-05-20T00:56:41Z",
    "path":"/aviation/observations/airport/NZWN/weatherStation/NZWNA/latest",
    "response":[
        {
            "met:station-id":"NZWNA",
            "met:product-name":"1minuteobservation",
            "met:domain":"aviation",
            "met:issue-time":"2019-05-20T00:56:25Z",
            "met:valid-at":"2019-05-20T00:56:00Z",
            "av:airport-location":"NZWN",
            "met:data":{
                "airTemperature01HourMax":"16.4",
                "airTemperature01HourMin":"15.9",
                "airTemperature01MinuteAverage":"16.2",
                "cloud1Amount30MinuteAverage":"NCD",
                "cloud1Height30MinuteAverage":"",
                "cloud2Amount30MinuteAverage":"",
                "cloud2Height30MinuteAverage":"",
                "cloud3Amount30MinuteAverage":"",
                "cloud3Height30MinuteAverage":"",
                "dewTemperature01MinuteAverage":"8.5",
                "equipmentTemperature01MinuteAverage":"19",
                "observationTimestamp":"20190520005600",
                "powerVoltage01MinuteAverage":"14.9",
                "presentWeatherNumeric115MinuteAverage":"//",
                "presentWeatherString115MinuteAverage":"//",
                "pressureMSL01HourMax":"1018.0",
                "pressureMSL01HourMin":"1017.8",
                "pressureMSL01MinuteAverage":"1017.8",
                "pressureQFE01HourMax":"1016.5",
                "pressureQFE01HourMin":"1016.3",
                "pressureQFE01MinuteAverage":"1016.3",
                "pressureQNH01HourMax":"1018.0",
                "pressureQNH01HourMin":"1017.8",
                "pressureQNH01MinuteAverage":"1017.8",
                "pressureSensor01HourChg":"-0.2",
                "pressureSensor01HourMax":"1017.5",
                "pressureSensor01HourMin":"1017.3",
                "pressureSensor01MinuteAverage":"1017.3",
                "rainfall01HourAccumulation":"0.00",
                "rainfall01HourMax":"0.00",
                "rainfall01MinuteAccumulation":"0.00",
                "rainfall10MinuteAccumulation":"0.00",
                "rainfall10MinuteMax":"0.00",
                "relativeHumidity01HourMax":"64.2",
                "relativeHumidity01HourMin":"59.6",
                "relativeHumidity01MinuteAverage":"60.3",
                "stationAlphaId":"NZWNA",
                "stationnNumericId":"93439",
                "stationStatusType":"NORMAL",
                "visibility01MinuteAverage":"17km",
                "visibility10MinuteAverage":"23km",
                "windCCW01HourMax":"334",
                "windCCW01MinuteMax":"344",
                "windCCW10MinuteMax":"334",
                "windCW01HourMax":"021",
                "windCW01MinuteMax":"005",
                "windCW10MinuteMax":"008",
                "windDirection01HourAverage":"002",
                "windDirection01MinuteAverage":"354",
                "windDirection10MinuteAverage":"354",
                "windGust01HourDirection":"359",
                "windGust01HourMax":"18",
                "windGust01HourTime":"39",
                "windGust01MinuteMax":"15",
                "windGust10MinuteMax":"17",
                "windLull01MinuteMin":"9",
                "windLull10MinuteMin":"7",
                "windRun01HourAccumulation":"24.6",
                "windSpeed01HourAverage":"13",
                "windSpeed01MinuteAverage":"12",
                "windSpeed10MinuteAverage":"12",
                "windCCWM01HourMax":"312",
                "windCCWM01MinuteMax":"322",
                "windCCWM10MinuteMax":"312",
                "windCWM01HourMax":"359",
                "windCWM01MinuteMax":"343",
                "windCWM10MinuteMax":"346",
                "windDirectionM01HourAverage":"340",
                "windDirectionM01MinuteAverage":"332",
                "windDirectionM10MinuteAverage":"332",
                "windGustM01HourDirection":"337"
            }
        }
    ]
}

23.2 Last n minutes or hours for a given Airport and Weather Station

Request the last n hours or minutes of observation data for a given airport and weather station. See tables below for supported airport (ICAO code) and weather stations.

23.2.1 API Call:

GET /aviation/observations/airport/{ICAODesignator}/weatherStation/{stationId}/last/{n}/{timeUnits}

23.2.2 Path Parameters:

Path Parameter	Example	Description
ICAODesignator	NZWN	A supported ICAO airport code (upper case). See table below for valid codes. This parameter is Mandatory.
stationId	NZWNB	The identifier for the Weather Station (upper case). See table below for valid Weather Station Identifiers. This parameter is Mandatory.
n	2	The duration in time units to return the data for. Valid values: up to 6 hours or 360 minutes. This parameter is Mandatory.
timeUnits	minutes	The time unit for the duration parameter (n). Valid values: hours or minutes (lower case). This parameter is Mandatory.

23.2.3Example:

This example would return the data observed in the last 2 minutes for Wellington Airport
weather station B.

GET /aviation/observations/airport/NZWN/weatherStation/NZWNB/last/2/minutes

23.2.4API Response:

{
    "version":"1.0",
    "issue-time":"2019-05-20T01:01:01Z",
    "path":"/aviation/observations/airport/NZWN/weatherStation/NZWNB/last/2/minutes",
    "response":[
        {
            "met:station-id":"NZWNB",
            "met:product-name":"1minuteobservation",
            "met:domain":"aviation",
            "met:issue-time":"2019-05-20T01:00:38Z",
            "met:valid-at":"2019-05-20T01:00:00Z",
            "av:airport-location":"NZWN",
            "met:data":{
                "airTemperature01HourMax":"16.4",
                "airTemperature01HourMin":"15.8",
                "airTemperature01MinuteAverage":"16.3",
                "cloud1Amount30MinuteAverage":"NCD",
                "cloud1Height30MinuteAverage":"",
                "cloud2Amount30MinuteAverage":"",
                "cloud2Height30MinuteAverage":"",
                "cloud3Amount30MinuteAverage":"",
                "cloud3Height30MinuteAverage":"",
                "dewTemperature01MinuteAverage":"9.2",
                "equipmentTemperature01MinuteAverage":"20",
                "observationTimestamp":"20190520010000",
                "powerVoltage01MinuteAverage":"13.7",
                "presentWeatherNumeric115MinuteAverage":"//",
                "presentWeatherString115MinuteAverage":"//",
                "pressureMSL01HourMax":"1018.0",
                "pressureMSL01HourMin":"1017.8",
                "pressureMSL01MinuteAverage":"1017.8",
                "pressureQFE01HourMax":"1016.5",
                "pressureQFE01HourMin":"1016.3",
                "pressureQFE01MinuteAverage":"1016.3",
                "pressureQNH01HourMax":"1018.0",
                "pressureQNH01HourMin":"1017.8",
                "pressureQNH01MinuteAverage":"1017.8",
                "pressureSensor01HourChg":"-0.2",
                "pressureSensor01HourMax":"1017.5",
                "pressureSensor01HourMin":"1017.3",
                "pressureSensor01MinuteAverage":"1017.3",
                "rainfall01HourAccumulation":"0.00",
                "rainfall01HourMax":"0.00",
                "rainfall01MinuteAccumulation":"0.00",
                "rainfall10MinuteAccumulation":"0.00",
                "rainfall10MinuteMax":"0.00",
                "relativeHumidity01HourMax":"65.8",
                "relativeHumidity01HourMin":"61.0",
                "relativeHumidity01MinuteAverage":"62.9",
                "stationAlphaId":"NZWNB",
                "stationnNumericId":"93482",
                "stationStatusType":"NORMAL",
                "visibility01MinuteAverage":"20km",
                "visibility10MinuteAverage":"20km",
                "windCCW01HourMax":"332",
                "windCCW01MinuteMax":"352",
                "windCCW10MinuteMax":"332",
                "windCW01HourMax":"025",
                "windCW01MinuteMax":"013",
                "windCW10MinuteMax":"016",
                "windDirection01HourAverage":"004",
                "windDirection01MinuteAverage":"002",
                "windDirection10MinuteAverage":"356",
                "windGust01HourDirection":"001",
                "windGust01HourMax":"19",
                "windGust01HourTime":"39",
                "windGust01MinuteMax":"14",
                "windGust10MinuteMax":"17",
                "windLull01MinuteMin":"9",
                "windLull10MinuteMin":"7",
                "windRun01HourAccumulation":"24.7",
                "windSpeed01HourAverage":"13",
                "windSpeed01MinuteAverage":"12",
                "windSpeed10MinuteAverage":"12",
                "windCCWM01HourMax":"310",
                "windCCWM01MinuteMax":"330",
                "windCCWM10MinuteMax":"310",
                "windCWM01HourMax":"003",
                "windCWM01MinuteMax":"351",
                "windCWM10MinuteMax":"354",
                "windDirectionM01HourAverage":"342",
                "windDirectionM01MinuteAverage":"340",
                "windDirectionM10MinuteAverage":"334",
                "windGustM01HourDirection":"339"
            }
        }
    ]
}

23.2.5 Table of Airport Codes and associated Weather Stations:

ICAO Airport Designators	Weather Station Identifiers	Description
NZWN	NZWNA	Wellington Airport and its Weather Station Identifiers
NZWN	NZWNB	Wellington Airport and its Weather Station Identifiers
NZWN	NZWNM	Wellington Airport and its Weather Station Identifiers
NZWN	NZWNN	Wellington Airport and its Weather Station Identifiers
NZWN	NZWNO	Wellington Airport and its Weather Station Identifiers
NZWN	NZWNP	Wellington Airport and its Weather Station Identifiers
NZWN	NZWNQ	Wellington Airport and its Weather Station Identifiers
NZWN	NZWNW	Wellington Airport and its Weather Station Identifiers